home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / DISK / CSAP312.ARJ / READ.ME < prev    next >
Text File  |  1992-02-16  |  6KB  |  123 lines
  1.            CSAP - Sort And Pack Directories [C source]
  2.  
  3. Author:  Don A. Williams
  4.  
  5. Version: 3.1.2   Date:    December 16, 1991
  6.  
  7. Very minor changes to allow  CSAP  to  compile  without  warnings 
  8. under  Borland's C++ 3.0 - CSAP was using a few implicit externs.  
  9. This version of CSAP works under MS-DOS 3.x, MS-DOS 4.x (with the 
  10. exception of a few models of the PS/2 that use FATs greater  than 
  11. 1 cluster,  MS-DOS 5.x,  DR DOS 3.x,  DR DOS 5.X, and DR DOS 6.0.  
  12. Under DR DOS 6.0,  it does not remove erased files controlled  by 
  13. DELWATCH (and probably shouldn't!) This version does still have a 
  14. problem  that  causes  Central Point Software's DISKFIX to detect 
  15. "cross  linked"  files  and,  occasionally,  corrupted  directory 
  16. entries.  By February 23,  1992,  CSAP,  version 3.2.0, should be 
  17. ready to correct these problems 
  18.  
  19. Version: 3.1.1   Date:    February 14, 1991
  20.  
  21. Made a very minor change to allow CSAP to run under  MS-DOS  5.0.  
  22. The  change  amounted  to nothing more than allowing "5" as a DOS 
  23. version number.  
  24.  
  25. Version: 3.1.0   Date:    July 11, 1990
  26.  
  27. Repaired  a  rather  major  problem  with  the   '-t',   Truncate 
  28. Directories,  option  and  empty  directories.  If  there  was  a 
  29. directory consisting of nothing but erased  files  and  CSAP  was 
  30. executed  WITHOUT the '-t' option and,  later,  CSAP was executed 
  31. WITH the '-t' option, many bad things including corruption of the 
  32. disk could occur!
  33. Also corrected the count of freed clusters which was one too high 
  34. and added a count of the freed bytes to the message.  
  35.  
  36.  
  37. Version: 3.0.2   Date:    June 20, 1990
  38.  
  39. Since  the  absread()  and  abswrite()  functions  provided  with 
  40. version 1.0 of Borland International's Turbo C++ support the long 
  41. sector  addresses required by partitions larger than 32 meg,  the 
  42. special routines used by CSAP are no longer needed and have  been 
  43. removed.  The GetDPB() function was recoded to eliminate assembly 
  44. language at the same time.
  45. Added  a  message  showing  the  number  of clusters freed by the 
  46. "Truncate Directories" option, '-t', and fixed a small bug in the 
  47. truncation routine.  
  48.  
  49. Version: 3.0.1   Date:    June 18, 1990
  50.  
  51. Version 3.0.1 of CSAP is nothing more  than  a  recompilation  of 
  52. CSAP  using  Turbo  C++ 1.0.  It is slightly smaller and slightly 
  53. faster than CSAP 3.0.0.  
  54.  
  55. Version: 3.0.0   Date:    May 11, 1990
  56.  
  57. Version 3.0.0 of CSAP can handle MS-DOS  4.xx  and  DR  DOS  3.xx 
  58. large  partitions.  It  also  introduces  the optional ability to 
  59. truncate directories,  i.e.  release unused directory disk  space 
  60. back to the free space pool.  CSAP now uses Chris Blum's Absolute 
  61. Disk  I/O  modifications  but  only  the OBJ file for the Compact 
  62. model in  included  in  the  CSAP  ZIP.  The  entire  package  is 
  63. available  on  CompuServ  in  IBMPRO  Library  #3  as ABRD40.ARC.  
  64. Version 3.0.0 of CSAP MUST be regarded as a "beta test" version - 
  65. there are now many different possible configurations and  I  have 
  66. not  been  able to test them all.  It has been tested with MS-DOS 
  67. 3.3 on the small partitions that 3.3 can handle and  with  MS-DOS 
  68. 4.01  and DR DOS 3.41 on small partitions and on large partitions 
  69. up to 70 meg.  I would highly recommend that you take a full save 
  70. of your hard disk before using CSAP 3.0.0 until you are sure that 
  71. it works with your particular setup.  
  72.  
  73. Version 2.1.1 of CSAP corrects the incorrect sorting on Date/Time 
  74. that was reintroduced in CSAP 2.0.9 and  later  versions.  Thanks 
  75. to David Klatzco for reporting it.  
  76.  
  77. Version 2.1.0 of CSAP corrects the handling of the '.'  and  '..' 
  78. directory  specifiers  and  adds  the  documentation  of the '-V' 
  79. option to CSAP.DOC (the '-V' has been operative in  the  program 
  80. for some time but was left out of the documentation.) 
  81.  
  82. CSAP  is  composed of 5 modules;  CSAP.C,  SORTDIR.C,  ISDEV.C.C, 
  83. GETDPB.C,  and ABSREAD.OBJ.  The current version  of  CSAP,  CSAP 
  84. 3.0.0ß,   has   been   designed   for  compilation  with  Borland 
  85. International's  Turbo  C  2.0.   The  module  ISDEV.C  could  be 
  86. replaced by Turbo C's supplied function isatty(), however, I plan 
  87. to extend ISDEV.C to distinguish among files,  CON,  AUX, and the 
  88. printer.  The function isatty() just distinguishes between  files 
  89. and the others.  
  90.  
  91. GETDPB.C cannot be compiled in Turbo C's interactive  environment 
  92. (TC).  It  is  primarily  inline  ASM  code and requires the more 
  93. conventional environment provided by Turbo C's TCC command.  As a 
  94. result,  CSAP was designed to be compiled through the  use  of  a 
  95. MAKEFILE and the MAKE facility of Turbo C.  
  96.  
  97. CSAP currently compiles and executes correctly in  any  of  Turbo 
  98. C's  supported  memory  models  except HUGE.  The memory model is 
  99. defined as a macro in the MAKEFILE and is supplied  on  the  MAKE 
  100. command line, i.e.: 
  101.  
  102.         MAKE -DMDL=s
  103.  
  104. to make a SMALL memory model version of CSAP  (the  "s"  must  be 
  105. lower  case  since  it  is  a  parameter  to  TCC and TCC is case 
  106. sensitive on its parameters).  The resultant  EXE  file  will  be 
  107. named  CSAPx.EXE where 'x' is C,  S,  M,  or L depending upon the 
  108. memory model selected.  The default memory model (if -DMDL is not 
  109. specified on the MAKE command) is the COMPACT model.  The current 
  110. MAKEFILE will NOT work properly for the TINY  memory  model,  the 
  111. library  specifications in the MAKEFILE would have to be modified 
  112. to use the SMALL libraries for the TINY model and the  effort  is 
  113. probably not worth it.  The command: 
  114.  
  115.         TCC -mt -G csap sortdir isdevice getdpb
  116.  
  117. would  have  to be used to produce a TINY memory model version of 
  118. CSAP and would produce an EXE file with the name CSAP.EXE.  
  119.  
  120. The  EXE  and OBJ files in the CSAPxxx ZIP have been produced for 
  121. the COMPACT model which is probably the most general.  
  122.  
  123.